home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 September (IDG) / Sep99.iso / Shareware World / Utilities / User Interface / OpenUsing CMM 1.3 / ReadMe 1.3 < prev   
Encoding:
Text File  |  1999-07-01  |  9.5 KB  |  145 lines  |  [TEXT/ttxt]

  1. OpenUsing Contextual Menu Plugin v1.3
  2.  
  3. © Damian Carter    1 Jul 1999
  4.  
  5. E-Mail:    Damian Carter <dmhc@s054.aone.net.au>
  6. URL:        http://www.home.aone.net.au/carter/
  7.  
  8.  
  9. Description
  10. This contextual menu plugin is used to open a file using an application other than the files creator, by taking advantage of MacOS 8's contextual menu. The plugin can also convert creator codes and file types to suit the chosen application.
  11.  
  12. OpenUsing is compatible with Sherlock (and probably more)!
  13.  
  14.  
  15. New in 1.3
  16. New features:
  17. • Added ability to use folder aliases anywhere in the “OpenUsing Folder”. You can even make the “OpenUsing Folder” itself a folder alias. Thanks to Otto Wyss for this suggestion.
  18. • If the name of a folder in the “OpenUsing Folder” ends with an ampersand (&), then the contents of that folder are loaded into the current menu without creating a submenu. Try it out, you’ll soon see what this means. Thanks to Vincent Jalby for this suggestion.
  19. Improvements:
  20. • Rewrote some of the menu loading code. Simplified code and reduced memory usage. This hopefully also addresses a mysterious error reported by J. Wehking.
  21. • Recompiled with Interfaces & Headers 3.2.
  22. • Only report ‘load’ error if different to last error. This only affects errors that are detected when the contextual menu is populated. Errors resulting from choosing a menu item that belongs to OpenUsing are always reported. This is to prevent the same error being reported every time you try to use the contextual menu. But since the error message appears only once - read it carefully!
  23. • Put a relevant description in the code fragment resource.
  24. • Easier to read font for this read me file (Geneva).
  25. • Reinstate version number in advanced user dialog.
  26. Bug Fixes:
  27. • Fixed a bug which caused OpenUsing to fail when the icon selected was that of a server or removable media. Thanks to Alan Eshelman and Alarik Skarstrom for bug reports.
  28. • No longer displays folders that contain only ignored items.
  29. • Fixed keyboard scrolling problem in advanced user dialog.
  30. • Fixed problem of advanced user dialog not automatically cancelling itself.
  31.  
  32. Thanks again to everyone who contributed to this release. Most of the major stuff in this resulted directly from such contributions.
  33.  
  34.  
  35. Requirements
  36. •MacOS 8 or better
  37. •A PowerPC Macintosh
  38.  
  39.  
  40. Installation
  41. • Drop the "OpenUsing CMPlugin" onto the System Folder.
  42. • Create a new folder called "OpenUsing Folder" in the Application Support folder, which is found in the System Folder.
  43. • Restart your Mac.
  44.  
  45. • Alternately, you can use the provided "OpenUsing Installer". This is an AppleScript that will copy the OpenUsing CMPlugin to the right place in the system folder, and create the "OpenUsing Folder" if necessary.  
  46. The script optionally installs aliases to the OpenUsing Scripts (see below).
  47.  
  48.  
  49. Configuration
  50. • Place aliases of applications in the OpenUsing Folder. Only application aliases and folders placed in the OpenUsing Folder will appear in the contextual menu. Folders and their contents appear as submenus, unless the name of the folder ends with an ampersand (see next point). 
  51. • If the name of a folder ends with an ampersand (&), the contents of the folder are loaded into the current menu without creating a further submenu. Try it! You’ll soon see what I mean.
  52. • Items are loaded in alphabetical order. Use the prefix "xx)" to order things as you want them to appear in the menus (where x is any character). The "xx)" prefix will not appear in the menus.
  53. • You can add separator lines to the menu by placing empty folders with names that end with a hyphen (-) in the OpenUsing Folder. Empty folders are otherwise ignored by the plugin.
  54. • Folder aliases may be used in place of a folder anywhere in the OpenUsing Folder. You can even make the “OpenUsing Folder” itself a folder alias. Everything mentioned above regarding folders also applies to folder aliases.
  55.  
  56. Configuration Notes
  57. • The OpenUsing Folder is checked every time you use the contextual menu. So if you make changes to the contents of the OpenUsing Folder it is not necessary to restart.
  58. • Folder nesting in the OpenUsing Folder is limited to a depth of 16. This ought to be more than enough…
  59. • Folder aliases which live inside the folder they refer to are detected and ignored (to thwart the circular alias problem).
  60.  
  61.  
  62. Usage
  63. • Select any number of files/folders/disks.
  64. • Control-click on the selection to open the contextual menu.
  65. • Choose an application from the "Open Using" submenu. The selected file(s) will be opened using the chosen application.
  66.  
  67. Usage Notes
  68. • Files in the selection are assumed to be of the same type as the first file.
  69. • If the application selected does not recognise the file's type you will be warned. You can instruct the plugin to try anyway (expect some odd results), or advanced users can change the file type to one that the application recognises (see below).
  70. •The Open Using submenu is not loaded if:
  71.   - if you control-click on something that is not an icon
  72.   - no files are selected (eg. desktop)
  73.   - an error occurs
  74. • Some applications cannot open files. For such applications setting the creator code or file type or opening files using the application is not possible, so an error message is displayed if you try to do so (except for AppleScript applets which are automatically launched). Such applications can only be launched. 
  75. • Some applications register no file types, but can attempt to open any file. For such applications converting the creator code or file type is not possible, so an error message is displayed if you try to do so (except for AppleScript droplets which are automatically launched and asked to open the file(s)). It is only possible to open the selected file(s) using such an application.
  76. • Many applications cannot open folders or disks. An error message will be displayed if you try to open a folder/disk with such an application.
  77. • If an error occurs while loading the OpenUsing submenu, the plugin will abandon the process, and the Open Using submenu will not appear in the contextual menu. The error will be reported after the contextual menu closes, but not if the error is the same as the last error reported.
  78. • Errors that arise from selecting an item from the OpenUsing submenu are always reported.
  79.  
  80.  
  81. Advanced Options
  82. • To also convert the selected file(s) creator code to match that of the chosen application, hold down command key when you choose the application from the menu.
  83.  
  84. • To open a dialog box which allows the file type to be changed, hold down the option key when you choose the application from the menu.
  85.   – The dialog box also allows the following actions to be specified:
  86.         - file type to convert to
  87.         - open file(s) using the application
  88.         - convert creator code and file type
  89.    – The following keyboard shortcuts are available when using the dialog box:
  90.         O: check "Open using" only
  91.         C: check "Convert Creator & Type" only
  92.         B: check both of above
  93.         up/down arrows: scroll file type menu
  94.         return/enter: OK
  95.         escape/command-period: Cancel 
  96.  
  97. Advanced Options Notes
  98. • If you are using this dialog, then you are assumed to know what you are doing: none of the usual warning messages are displayed when you use this dialog.
  99. • These advanced options are unavailable for disks and folders. 
  100. • The original creator code and file type of the first file in the Finder selection are displayed inside parenthesis on the right hand side of the dialog. 
  101. • The dialog box is automatically placed close to the mouse cursor to minimise mouse travel and speed use of the dialog. The dialog box will cancel itself after around 30 seconds if no actions occur in the dialog box. The cancel button will flash occasionally as a warning. This is to minimise how long Finder is held up by the modal dialog box.
  102. • If you hold down both the command and option keys, then the dialog box is opened with the open using checkbox not checked (it is checked by default).
  103.  
  104.  
  105. OpenUsing Scripts
  106. This folder contains two useful AppleScripts to help you configure the OpenUsing Folder. They can be used as regular scripts, or (to be really cool) place aliases of them in the OpenUsing Folder.
  107.  
  108. The script "OpenUsing Folder" is an AppleScript applet that simply opens that folder so you can deal with it directly. Saves hunting around in the System Folder.
  109.  
  110. The "Add Application Alias" is an AppleScript droplet. Drop an application onto the script and it will insert an alias of that application into the OpenUsing Folder.
  111.  
  112.  
  113. Future
  114. •Please email me your suggestions!
  115.  
  116.  
  117. Version History
  118. •1.2 (26 May 1999)
  119.   - Added ability to use the plugin with folders and disks.
  120.   - Display original file type &  creator code in advanced dialog.
  121.   - No longer attempts to change creator code / file type of folders /  disks.
  122.   - Carbon compatibility (unproven…).
  123.  
  124. •1.1.1 Final (15 March 1999)
  125.   - Finally got a copy of MSIE to formally test the plugin.
  126.  
  127. •1.1.1Beta 1 (30 January 1999)
  128.   - Bug fix: a problem found causing contextual menus to fail completely in MSIE (and potentially other applications) was fixed (hopefully).
  129.   - Bug Fix: keyboard shortcuts (O, C & B) now work even when caps lock is active!
  130.  
  131. •1.1 (29 November 1998)
  132.   - Simplified operation.
  133.   - Dialog box no longer appears by default.
  134.   - Vastly improved handling of situations where application chosen does not recognise the file(s).
  135.   - Vastly improved handling and reporting of errors.
  136.   - When a bad alias is encountered, offer to select it in Finder.
  137.  
  138. •1.0.0 (15 November 1998)
  139.   - First public release
  140.  
  141.  
  142. Freeware
  143. OpenUsing CMPlugin is free for personal use. Send me an email if you use it and I'll notify you of any updates.
  144.  
  145. Commercial users, please contact me to arrange terms.